Documentación de PrestaShop Watermark CC
Documentación completa del módulo de marcas de agua para PrestaShop (cc_ps_watermark) con sistema avanzado de copias de seguridad, regeneración automática de miniaturas y gestión detallada de marcas de agua.Índice
- Introducción
- Instalación
- Activación de la licencia
- Panel de gestión
- Configuración general
- Configuración de la marca de agua
- Sistema de reserva
- Regeneración de miniaturas
- Gestión de registros
- CRON y automatización
- Gestión de fuentes
- Resolución de problemas
- PREGUNTAS FRECUENTES
1. introducción
CC PrestaShop Watermark es un módulo avanzado que le permite añadir automáticamente marcas de agua a todas las miniaturas de productos de su tienda PrestaShop. El módulo ofrece un sistema integral para proteger las imágenes originales mediante copias de seguridad automáticas y herramientas avanzadas para gestionar el proceso de marca de agua de las imágenes.Funciones principales del módulo:
- Añadir marcas de agua de texto e imagen
- Sistema automático de copia de seguridad de las imágenes originales
- Regeneración de todas las miniaturas con marca de agua
- Compatibilidad con fuentes TTF no estándar
- Procesamiento selectivo de tipos de miniaturas
- Sistema detallado de registro de actividades
- CRON para la regeneración automática
- Restauración de imágenes originales a partir de copias de seguridad
- Interfaz administrativa multilingüe
- Sistema de licencias con todas las funciones
2. instalación
Requisitos del sistema- PrestaShop 1.7.0.0 o posterior
- PHP 7.2 o posterior
- MySQL 5.6 o posterior
- Extensión GD para PHP (para el tratamiento de imágenes)
- Permisos de escritura para los directorios img/ y modules/.
- 512 MB de RAM como mínimo (1 GB recomendado para tiendas grandes)
- Funciones Imagettftext para fuentes TTF
- Descargue el archivo ZIP del módulo de la tienda oficial códigos.cocos
- Inicie sesión en el panel de administración de PrestaShop
- Vaya a: Módulos > Gestor de módulos > Añadir nuevo módulo
- Haga clic en "Añadir módulo" y seleccione el archivo ZIP descargado.
- Una vez finalizada la instalación, haga clic en "Configurar".
- El módulo creará automáticamente los siguientes directorios: backups/, uploads/, fonts/
Información
Tras la instalación, el módulo creará automáticamente las tablas necesarias de la base de datos (cc_ps_watermark_log, cc_ps_watermark_backups, cc_ps_watermark_processed), los directorios para las copias de seguridad y establecerá la configuración predeterminada. Antes de empezar a trabajar, recomendamos activar la licencia y añadir fuentes TTF al directorio fonts/.
3. activación de la licencia
Antes de poder utilizar todas las funciones del módulo, es necesario activar la licencia:- Tras la instalación, proceda a la configuración del módulo
- Seleccione la pestaña "Licencia
- Introduzca la clave de licencia recibida tras la compra
- Haga clic en "Activar licencia".
- Tras la activación, aparecerá un mensaje de confirmación.
- Todas las funciones del módulo estarán desbloqueadas
Advertencia
Sin una licencia activa, el módulo funcionará en modo restringido: las funciones AJAX estarán bloqueadas y se mostrará un mensaje en la parte superior del panel de administración indicando que la licencia no está activa. Las funciones básicas de marca de agua estarán disponibles, pero sin opciones avanzadas de gestión.
4 Panel de gestión
El panel de gestión del módulo consta de varias pestañas que permiten una configuración y gestión completas:Pestañas principales:
- Ajustes - configuración del módulo principal, estilo de la marca de agua
- Regeneración de miniaturas - Herramientas CRON de regeneración de imágenes
- Copias de seguridad - gestión de las copias de seguridad de las imágenes originales
- Registros - historial de actividad del módulo con sistema de filtrado
- Documentación - enlace a la documentación en línea
- Ayuda - enlace a la página de asistencia
- Plug-ins - extensiones COCOS adicionales
- Licencia - gestión de licencias de módulos
5. ajustes generales
En la sección de ajustes generales encontrarás las opciones básicas que controlan el funcionamiento del módulo:| Configuración | Descripción | Valor por defecto |
| Encender el módulo | Encendido/apagado global del módulo | Fuera de |
| Activar copias de seguridad | Creación automática de copias de imágenes originales | En |
- Módulo sobre - las marcas de agua se añaden automáticamente a los productos nuevos y actualizados
- Módulo apagado - no se añaden marcas de agua, pero las existentes permanecen intactas
- Copias de seguridad activadas - se realiza una copia del original antes de cada modificación de la imagen
- Copias de seguridad desactivadas - las imágenes se modifican directamente sin copias
Consejo
Recomendamos dejar activadas las copias de seguridad para poder restaurar las imágenes originales en caso necesario. Utiliza el interruptor principal del módulo para apagarlo rápidamente durante las tareas de mantenimiento.
6. Configuración de la marca de agua
El módulo ofrece dos tipos principales de marca de agua con una amplia configuración para cada uno de ellos:Tipo de marca de agua
Existen dos opciones para etiquetar imágenes:
| Tipo | Descripción | Requisitos |
| Texto | Marca de agua de texto con configuración de fuente y color | Fuente TTF opcional |
| Imagen | Marca de agua de imagen con transparencia | Archivo PNG/JPG/GIF |
Configuración de marcas de texto
- Texto de marca de agua - contenido que se mostrará (por defecto: "COCOS.CODES")
- Fuente TTF - una selección de las fuentes disponibles en el directorio fonts/.
- Tamaño de letra - De 8 a 200 píxeles (por defecto: 24px)
- Color del texto - selección de color en formato HEX (por defecto: #FFFFFF)
- Archivo de imagen - Transferencia de archivos PNG con transparencia
- Panorama de la situación actual - visualización de la imagen utilizada actualmente
- Tamaño máximo - 2 MB por archivo
- Formatos admitidos - PNG, JPG, JPEG, GIF
- Posición de la marca de agua - 9 posiciones a elegir (esquinas, centro, centro)
- Repetir marca de agua - duplicación en toda la imagen
- Transparencia - 0% (invisible) a 100% (opaco)
Podemos seleccionar qué tipos de miniaturas etiquetar:
- Lista de todos los tipos de imágenes de productos disponibles
- Visualización de cualquier tipo de resolución
- Cualquier combinación es posible
- Por defecto: se marcan todos los tipos
Nota
Si no selecciona ningún tipo de miniatura, el módulo marcará todos los tipos disponibles. El cambio de ajustes sólo se aplica a las imágenes recién procesadas - utilice la función de regeneración para actualizar las imágenes existentes.
7. sistema de copias de seguridad
Uno de los elementos más importantes del módulo es un completo sistema para salvaguardar las imágenes originales:Creación automática de copias
El sistema crea automáticamente copias de seguridad:
- Antes de añadir una marca de agua a una imagen por primera vez
- Para cada tipo de miniatura por separado
- Conservar la estructura original de directorios
- Con metadatos en la base de datos
El panel muestra información útil:
- Número total de copias de seguridad - todas las copias de seguridad creadas
- Productos con copias de seguridad - número de productos con imágenes protegidas
- Uso del disco - tamaño total de todas las copias
- Última copia de seguridad - fecha de la última copia de seguridad
Operaciones disponibles en las copias de seguridad:
| Operación | Descripción | Comentarios |
| Restaurar todas las copias | Restaura las imágenes originales de todas las copias | Elimina las marcas de agua de toda la tienda |
| Borrar todas las copias | Borra permanentemente todas las copias del disco | Cirugía irreversible |
| Restaurar copias de productos | Restaura las imágenes sólo del producto seleccionado | Disponible para cada producto por separado |
Una tabla detallada que incluye:
- ID y nombre del producto
- Número de copias de seguridad
- Espacio necesario
- Fecha de la última copia de seguridad
- Botón de restauración para cada producto
El sistema se ha optimizado para mejorar el rendimiento:
- 20 productos por página
- Carga eficaz de listas de gran tamaño
- AJAX para operaciones sobre copias
- Actualización automática de las estadísticas
Advertencia
Las operaciones sobre las copias de seguridad son irreversibles. La restauración de una copia elimina las marcas de agua y el borrado de una copia imposibilita la restauración de las imágenes originales. Recomendamos hacer una copia de seguridad de toda la tienda antes de realizar operaciones importantes.
8 Regeneración de miniaturas
Un avanzado sistema de regeneración permite aplicar marcas de agua a las imágenes existentes:Regeneración manual
Procesamiento inmediato de todas las miniaturas:
- "Botón "Regenerar miniaturas ahora
- Confirmación antes del inicio de las operaciones
- Barra de progreso con información de estado
- Mensajes de éxito o error
El sistema permite programar la regeneración automática:
0 2 * * * /usr/bin/php /path/to/prestashop/modules/cc_ps_watermark/cron.phpArchivo CRON
El módulo incluye una oferta dedicada cron.php archivo:
- Comprobar si el módulo está activo
- Establecimiento de límites de tiempo y memoria
- Exactamente la misma funcionalidad que el botón del panel
- Registro de los resultados en la consola
- Mensajes de error multilingües
Alternativamente, CRON se puede utilizar a través de HTTP:
http://twoja-domena.pl/modules/cc_ps_watermark/cron.php?token=WYGENEROWANY_TOKENSe ha optimizado el sistema de regeneración:
- Procesamiento en lotes de 10 productos
- Liberación automática de la memoria
- Soporte para límites de tiempo (10 minutos para CRON)
- Aumento del límite de memoria a 512 MB
Consejo
Recomendamos que la regeneración se realice durante las horas de menor tráfico en la tienda. Para tiendas grandes (>1000 productos), utilice CRON en lugar de la regeneración manual a través del navegador.
9. gestión de registros
Un completo sistema de registro realiza un seguimiento de todas las actividades del módulo:Tipos de eventos registrados
El sistema registra las siguientes acciones:
| Acción | Descripción | Información adicional |
| procesar_imagen | Tratamiento de una sola imagen | Ruta del archivo, estado, errores |
| crear_copia_de_seguridad | Copia de seguridad | Ubicación de la copia de seguridad |
| restaurar_reserva | Restaurar a partir de una copia | Archivo restaurado |
| regenerar_todos | Regeneración de todas las miniaturas | Número de imágenes procesadas |
| producto_proceso | Tratamiento del producto | ID del producto, número de imágenes |
Cada entrada incluye:
- ID de registro - identificador único de la entrada
- Fecha y hora - hora exacta de la operación
- Acción - tipo de operación realizada
- Identificación del producto - Producto relacionado (si procede)
- Estado - éxito, advertencia, error, información
- Mensaje - descripción detallada del incidente
Funciones disponibles:
- Paginación - 50 entradas por página
- Clasificación - últimas entradas en la parte superior
- Limpieza de los troncos - eliminación de todas las entradas
- Rotación automática - un máximo de 5000 entradas
Indicación visual de validez:
- éxito - verde (operación completada con éxito)
- advertencia - amarillo (advertencias, errores parciales)
- error - rojo (errores críticos)
- información - azul (información general)
Información
El sistema mantiene automáticamente un máximo de 5.000 entradas de registro. Las entradas más antiguas se borran automáticamente. Para mantener un historial completo, se recomienda exportar periódicamente los registros de la base de datos.
10. CRON y automatización
Detalles de la automatización de procesos del módulo:Configuración del servidor
Para configurar la regeneración automática en el servidor:
- Inicie sesión en cPanel/Plesk o mediante SSH
- Busque la sección "Tareas CRON" o "Cron Jobs".
- Añada una nueva tarea con el comando indicado en el panel del módulo
- Ajuste la frecuencia según sus necesidades (recomendado: cada noche)
- Compruebe que la ruta a PHP es correcta
Dependiendo del servidor, la ruta puede ser diferente:
/usr/bin/php
/usr/local/bin/php
/opt/php/bin/php
php (si está presente en PATH)Diferentes frecuencias de regeneración:
| Horario | Descripción | Comando CRON |
| Todos los días a las 2 de la madrugada. | Recomendado para la mayoría de los comercios | 0 2 * * * |
| El domingo de cada semana | Para comercios con cambios poco frecuentes | 0 2 * * 0 |
| Cada 6 horas | Para tiendas que se actualizan con frecuencia | 0 */6 * * * |
| Todos los meses | Frecuencia mínima | 0 2 1 * * |
Para comprobar que CRON funciona correctamente:
- Comprobar los registros del módulo después del tiempo de ejecución programado
- Pruebe la llamada cron.php manualmente a través de su navegador
- Compruebe si hay errores PHP en los registros del servidor
- Asegúrese de que el módulo está activo
El archivo cron.php contiene funciones de seguridad:
- Comprobación de la actividad del módulo
- Validación de tokens para el acceso HTTP
- Registro de todas las operaciones
- Gestión eficaz de errores
Nota
El token para la URL de CRON se genera automáticamente en función de la configuración de PrestaShop y proporciona seguridad básica. Para mayor seguridad, recomendamos utilizar CRON a través de la línea de comandos en lugar de HTTP.
11. gestión de fuentes
Sistema de soporte de fuentes personalizadas TTF para marcas de agua de texto:Catálogo de fuentes
Las fuentes TTF deben colocarse en el directorio:
/modules/cc_ps_watermark/fonts/El módulo sólo admite fuentes TTF (TrueType Font):
- Extensión: .ttf
- Comprobación de la existencia de un fichero antes de su utilización
- Detección automática de fuentes disponibles
- Nombres amigables basados en nombres de archivo
Fuentes sugeridas:
| Fuente | Descripción | Mejor uso |
| Roboto-Regular.ttf | Predeterminado, moderno, legible | Uso universal |
| Arial-Bold.ttf | Audaz, distintivo | Marcas de agua claras |
| OpenSans-Light.ttf | Ligero, elegante | Marcas de agua sutiles |
| Impacto.ttf | Ancho, fuerte | Protección contra la piratería |
Sistema automático:
- Busca archivos TTF en el directorio fonts/.
- Genera nombres amigables (por ejemplo, "Roboto Regular" con "Roboto-Regular.ttf")
- Comprueba la disponibilidad de la función imagettftext
- Ofrece una alternativa a las fuentes incorporadas
El panel informa sobre el estado de las fuentes:
- Sin fuentes - advertencia sobre un directorio fonts/ vacío
- Lista de disponibles - selección entre las fuentes TTF detectadas
- La fuente no existe - error de validación en la entrada
Si no se dispone de una fuente TTF, el módulo utiliza:
- Fuente GD integrada (tamaño 5, el mayor disponible)
- Recálculo automático de la posición del texto
- Conservación de todos los demás ajustes
Consejo
Para añadir una nueva fuente, basta con cargar el archivo TTF en el directorio fonts/ y actualizar la página de configuración. La fuente aparecerá automáticamente en la lista de selección. Recomendamos utilizar fuentes con una licencia que permita su uso comercial.
12 Solución de problemas
No se añaden marcas de agua a los productos nuevos- Compruebe si el módulo está activado en los ajustes generales
- Asegurarse de que la licencia está activa
- Compruebe que ha seleccionado los tipos de miniaturas correctos
- Compruebe que la extensión GD está instalada
- Compruebe los permisos de escritura en los directorios img/.
- Compruebe los límites de memoria de PHP (recomendado: mín. 512MB)
- Aumentar max_execution_time en PHP (recomendado: 300 segundos)
- Compruebe que todas las imágenes de los productos son correctas
- Utilizar CRON en lugar de un navegador para las grandes tiendas
- Compruebe los registros del módulo para ver los detalles del error
- Compruebe los permisos de escritura en el directorio modules/cc_ps_watermark/backups/
- Asegúrese de que hay espacio suficiente en la unidad
- Compruebe que el directorio de copias de seguridad se ha creado durante la instalación.
- Verificación de la integridad de la base de datos (tabla cc_ps_watermark_backups)
- Compruebe los registros del módulo en busca de errores relacionados con las copias de seguridad
- Compruebe que la ruta a PHP en CRON es correcta
- Verifique los permisos del archivo cron.php (755)
- Asegúrese de que el módulo está activo durante la ejecución de CRON
- Compruebe si hay errores en los registros del servidor
- Pruebe la ejecución de cron.php manualmente a través de SSH
- Compruebe que la extensión GD es compatible con TTF (función imagettftext)
- Asegúrese de que los archivos de fuentes tienen la extensión .ttf
- Verificar los derechos para leer archivos de fuentes (644)
- Compruebe que la ruta a la fuente es correcta
- Compruebe que el archivo de fuentes no está dañado
- Comprueba el tamaño de las copias de seguridad en la pestaña "Copias de seguridad".
- Considere la posibilidad de eliminar las copias de seguridad antiguas
- Optimice las imágenes de los productos antes de añadir marcas de agua
- Utilizar la compresión de imágenes en la configuración de PrestaShop
- Limpie regularmente las copias de seguridad innecesarias
Error
Si encuentras problemas irresolubles con el módulo, asegúrate de que estás utilizando la última versión y de que tu tienda PrestaShop está actualizada. Compruebe también que dispone de suficientes recursos de servidor (RAM, CPU, espacio en disco). En caso de dificultades, póngase en contacto con el servicio de asistencia de COCOS a través de la siguiente página cocos.codes/soporte.
13. PREGUNTAS FRECUENTES
¿Puedo restaurar las imágenes originales después de añadir marcas de agua?Sí, si tienes activadas las copias de seguridad. Utiliza la función "Restaurar todas las copias" de la pestaña "Copias de seguridad" o restaura las copias de un producto concreto.
¿Con qué frecuencia debo regenerar las miniaturas?
Depende de la frecuencia con que se añadan los productos. Para tiendas activas, recomendamos la regeneración diaria por CRON. Para las menos activas, semanalmente o según sea necesario.
¿Puedo utilizar mis propias fuentes TTF?
Sí, cargue los archivos TTF en el directorio /modules/cc_ps_watermark/fonts/ y aparecerán automáticamente en la lista de selección. Asegúrate de que tienes derecho a utilizar las fuentes con fines comerciales.
¿Qué pasa si desactivo las copias de seguridad?
Las imágenes se modificarán directamente sin posibilidad de restaurar las versiones originales. No recomendamos desactivar esta opción.
¿Puedo añadir una marca de agua sólo a determinados tipos de miniaturas?
Sí, en los ajustes puede seleccionar los tipos específicos de miniaturas que desea marcar. Los tipos no seleccionados permanecerán sin cambios.
¿Cómo puedo comprobar que CRON funciona correctamente?
Compruebe la pestaña "Registros" después de la hora programada de ejecución de CRON. Deberían aparecer entradas de regeneración. También puede probar la llamada cron.php manualmente.
¿Puedo cambiar la posición de la marca de agua para los distintos tipos de miniaturas?
Actualmente, la posición es global para todos los tipos de miniaturas. Posiciones separadas para diferentes tipos requieren modificación de código.
¿Qué formatos de imagen admite la marca de agua?
Se admiten los formatos PNG, JPG, JPEG y GIF. Recomendamos PNG con transparencia para obtener mejores resultados.
¿Puedo utilizar el módulo en una tienda con miles de productos?
Sí, pero recomendamos usar CRON para regenerar y monitorizar los recursos del servidor. Las tiendas grandes pueden necesitar aumentar los límites de PHP.
¿Qué significa "La imagen ya tiene una marca de agua" en los registros?
El sistema hace un seguimiento de las imágenes que ya han sido procesadas y no vuelve a añadir la marca de agua. Este es un comportamiento normal para evitar marcas duplicadas.
¿Puedo exportar los registros del módulo?
Actualmente no existe una función de exportación integrada, pero todos los registros se encuentran en la tabla cc_ps_watermark_log y pueden exportarse a través de phpMyAdmin.
¿Cómo puedo eliminar todas las marcas de agua de la tienda?
Utiliza la función "Restaurar todas las copias" de la pestaña "Copias de seguridad". Esto restaurará las imágenes originales de todas las copias de seguridad.
¿Afecta el módulo al rendimiento de la tienda?
Durante el funcionamiento normal, el impacto es mínimo. El procesamiento de imágenes solo tiene lugar al añadir/actualizar productos o durante la regeneración.
¿Qué ocurre cuando caduca la licencia?
Las funciones básicas funcionarán, pero las opciones avanzadas como AJAX, las copias de seguridad y la regeneración pueden estar limitadas. Le recomendamos que renueve su licencia.
¿Puedo utilizar el módulo en un entorno de prueba?
Sí, la licencia también permite el uso en subdominios de prueba y entornos de desarrollo locales de acuerdo con los términos de la licencia.
¿Qué tamaño pueden tener los archivos de fuentes?
No hay un límite estricto, pero recomendamos fuentes de hasta 2 MB. Los archivos más grandes pueden afectar al rendimiento al procesar imágenes.
¿Puedo utilizar emoji o caracteres especiales en el texto de la marca de agua?
Sí, si la fuente TTF utilizada admite los caracteres en cuestión. Las fuentes GD incorporadas tienen un soporte limitado para caracteres especiales.
¿Qué significa el error "Extensión GD no disponible"?
Esto significa que la extensión GD para PHP, necesaria para el procesamiento de imágenes, no está instalada en el servidor. Póngase en contacto con el administrador del servidor.
¿Puedo añadir automáticamente marcas de agua a las imágenes cargadas a través de FTP?
El módulo procesa automáticamente las imágenes sólo para las operaciones a través del panel de PrestaShop. Las imágenes añadidas a través de FTP requieren la regeneración de miniaturas.
¿Cómo puedo cambiar el tamaño máximo de la imagen de marca de agua cargada?
El límite de 2MB está definido en la clase ImageHelper. El cambio requiere modificar el código y aumentar los límites de PHP upload_max_filesize.
Éxito
El módulo CC PrestaShop Watermark es una herramienta profesional para proteger las imágenes de los productos en las tiendas en línea. Con un avanzado sistema de copia de seguridad, automatización de procesos y un detallado sistema de registro, proporciona una gestión segura y eficaz de las marcas de agua en todas las imágenes de productos.
